<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML3.2 EN">
<HTML>
<HEAD>
<META NAME="GENERATOR" CONTENT="DOCTEXT">
<TITLE>MPE_Describe_state</TITLE>
</HEAD>
<BODY BGCOLOR="FFFFFF">
<A NAME="MPE_Describe_state"><H1>MPE_Describe_state</H1></A>
Describe the attributes of a state without byte informational data in MPI_COMM_WORLD. 
<H2>Synopsis</H2>
<PRE>
int MPE_Describe_state( int state_startID, int state_finalID,
                        const char *name, const char *color )
</PRE>
<H2>Input Parameters</H2>
<DL>
<DT><B>state_startID </B><DD>event number for the beginning of the state.

<DT><B>state_finalID </B><DD>event number for the ending of the state.

<DT><B>name          </B><DD>name of the state,
the maximum length of the NULL-terminated string is,
sizeof(CLOG_DESC), 32.

<DT><B>color         </B><DD>color of the state,
the maximum length of the NULL-terminated string is,
sizeof(CLOG_COLOR), 24.
</DL>
<P>
<H2>Notes</H2>
Adds a state definition to the logfile.
States are added to a log file by calling 'MPE_Log_event()'
for the start and end event numbers.  The function is provided
for backward compatibility purpose.  Users are urged to
use 'MPE_Describe_comm_state()' and 'MPE_Log_comm_event()' instead.
<P>
This function is threadsafe.
<P>
<H2>See Also</H2>
 MPE_Log_get_state_eventIDs(), MPE_Describe_comm_state()
<BR><P><B>Location:</B>../src/logging/src/mpe_log.c<P>
</BODY></HTML>
